Chuyển tới nội dung chính

Tùy chọn chung

Mô-đun này khả dụng trong các phiên bản sau 20260507

Một số API ui_element nhận bảng tùy chọn để chỉ định ứng dụng đích, số lượng kết quả, độ sâu phần tử con, kiểm tra tương tác và số bước thao tác.

Tùy chọn truy vấn​

local options = {
pid = app.front_pid(),
max_level = 2,
max_elements = 200,
include_hit_state = true,
}
  • pid
    Số nguyên. Mã định danh tiến trình của ứng dụng đích. Khi bỏ qua, ứng dụng ở nền trước thường được dùng.
  • max_level
    Số nguyên. Độ sâu mở rộng phần tử con. Dùng 1 hoặc 2 để giữ dữ liệu trả về ở mức nhỏ.
  • max_elements
    Số nguyên. Số phần tử cấp cao nhất tối đa cần trả về.
  • fallback_children
    Boolean. Thử đọc phần tử con khi danh sách thông thường rỗng. Giá trị mặc định tùy thuộc vào API.
  • include_hit_state
    Boolean. Bao gồm các trường trạng thái tương tác.
  • hit_test
    Boolean. Bật tra cứu tương tác bằng cách lấy mẫu màn hình. Kịch bản thông thường thường không cần tùy chọn này.
  • fallback_hit_test
    Boolean. Thử tra cứu tương tác bằng cách lấy mẫu màn hình khi danh sách thông thường rỗng.
  • hit_test_spacing
    Số. Khoảng cách lấy mẫu màn hình theo tọa độ logic. Mặc định là 40.

Tùy chọn loại trừ thuộc tính​

Có từ phiên bản 20261115. Chỉ dùng cho snapshot() và list_text_elements(). Tất cả đều là kiểu boolean, mặc định false và cũng áp dụng cho phần tử con. Khi không cần các trạng thái này, bật các tùy chọn loại trừ có thể giảm chi phí truy vấn và tăng tốc lấy ảnh chụp UI.

  • exclude_visibility
    Khi là true, bỏ qua truy vấn khả năng hiển thị và không trả về isVisible.
  • exclude_map
    Khi là true, bỏ qua kiểm tra thuộc tính bản đồ và không trả về isMap; vẫn giữ các phần tử bản đồ.
  • exclude_hit_state
    Khi là true, bỏ qua kiểm tra hit tại điểm trung tâm và không trả về canHit, hitVerified, hitTestPoint và hitTestPointLogical. Không thể dùng cùng include_hit_state = true.

Phạm vi phần tử, văn bản, tọa độ và quy tắc tìm bổ sung phần tử của hit_test / fallback_hit_test không thay đổi. Không loại trừ trường trạng thái nếu cần lọc theo trường đó.

Tùy chọn thao tác​

  • point
    Bảng. Điểm tọa độ dùng để cuộn hoặc tra cứu tương tác, ví dụ { x = 200, y = 700 }, tính bằng pixel vật lý.
  • x / y
    Số nguyên. Giống point, nhưng được đặt trực tiếp trong bảng tùy chọn.
  • steps
    Số. Tham số bước cho thao tác cuộn, tăng hoặc giảm. Hiệu quả thực tế phụ thuộc vào điều khiển đích.

Mô tả​

list_text_elements() giữ các giá trị mặc định thận trọng cho kịch bản cũ. find(), find_all(), snapshot() và các API thao tác thường phù hợp hơn với kịch bản mới. hit_test có thể trả về các phần tử gần lớp trên cùng hiện tại hơn nhưng tốn nhiều tài nguyên hơn. Chỉ dùng khi truy vấn thông thường không tìm thấy mục tiêu.